Skip to content

fix(docs): 纠正 V2 下载、Preview 范围与空页面误导 - #10

Merged
ceastld merged 8 commits into
mainfrom
cursor/fix-v2-user-docs-3d62
Aug 16, 2026
Merged

fix(docs): 纠正 V2 下载、Preview 范围与空页面误导#10
ceastld merged 8 commits into
mainfrom
cursor/fix-v2-user-docs-3d62

Conversation

@ceastld

@ceastld ceastld commented Aug 16, 2026

Copy link
Copy Markdown
Contributor

纠正用户文档里会误导安装、Preview 范围和更新记录的内容,并清掉线上空页与分类落地 404。

改了什么

  • 安装下载docs/v2/install/windows.md 改为 https://getquicker.net/V2,明确不要从仍提供 1.x 的 /Download 下载;一句提到可能需要 .NET 10 桌面运行时。
  • Preview / 专业版 / 免费版 / 勿替关键环境:六个用户入口页(首页、开始使用、安装、迁移、常见问题、V2 重要变化)加上一致的 caution。important-notice 扩为「体验前必读」,并链到首页;写入 2.1.0 降级风险,以及官网 2.1.17 记录中「回退到 2.1.15 需重填 AI API 密钥」。
  • 不能双开:迁移页改成可执行清单(同步备份 → 卸载 1.x → 从 /V2 安装 → 首次登录分叉 → 验证 → 回退重装 1.x)。不再写成「可以共存、只是别交叉改动作」。
  • 更新记录/release-notes 不再是「编写建议」stub,改为指向 https://getquicker.net/v2/versions。导航仍走站内页。
  • 空页update / account-and-sync / scenes / tools 改成枢纽页;load-action-page 补了新面板加载场景/动作页的做法。
  • 分类 404:新增 /v2/v2/install/v2/migration 落地页(原先 generated-index 落到 /category/quicker-v2)。
  • sitemap:不重命名 what's-new/createSitemapItems 把 loc 里的 ' 编成 %27。本环境 curl 现网 sitemap 为 200 且含未编码撇号;部分 XML 消费端(含 WebFetch)会报 500。本地 npm run buildbuild/sitemap.xml 结构合法,274 条 loc,what's-new 已编码。
  • 中优先级:触发概览去掉「即将补充」并标明仍缺独立说明的项;contributing 对用户侧栏 unlisted;页脚「文档中心」改为「1.x 文档」并增加官网 V2;模块分类描述去重;新增 AI 与 Agent 现状页(不承诺 Agent / 计算机控制 / 手机遥控已开放)。

未做

  • 不重命名 what's-new/
  • 不导入完整官网 changelog
  • 不写 Agent / Computer Use / Browser Use 教程
  • 不接入评论后端

验证

  • npm run typecheck 通过
  • npm run build 通过(onBrokenLinks: throw
  • 产物存在:/v2/v2/install/v2/migration/release-notes/important-notice/v2/features/ai-and-agent
  • /category/quicker-v2 不再生成
  • 上述空页构建结果中不再出现「待补充」
  • 首页侧栏无「编写约定」,页脚为「1.x 文档」
  • build/sitemap.xml 合法,what%27s-new 已编码
  • Preview 提示已改为 :::caution[标题],构建 HTML 渲染为 theme-admonition-caution

首页 Preview 提示
安装页指向 /V2
迁移清单要求卸载 1.x
更新记录指向官网
AI 与 Agent 现状
docs_v2_preview_hubs_and_changelog.mp4

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

cursoragent and others added 7 commits August 16, 2026 22:55
安装页改为 getquicker.net/V2,明确不要从仍提供 1.x 的 /Download 下载。
六个用户入口页补充 Preview / 专业版 / 免费版暂不能登录 / 勿替关键环境。
重要提示扩为体验前必读,并写明 2.1.0 降级与回退 2.1.17 前需重填 API 密钥。

Co-authored-by: Cea <ceastld@users.noreply.github.com>
迁移改为可执行步骤:同步备份、卸载 1.x、从 /V2 安装、首次登录分叉、验证、回退重装 1.x。
数据同步页同步写明浏览器扩展冲突,不能同时安装。

Co-authored-by: Cea <ceastld@users.noreply.github.com>
去掉仍是编写建议的空 stub,入口指向 https://getquicker.net/v2/versions。

Co-authored-by: Cea <ceastld@users.noreply.github.com>
把待补充 stub 改成指向已有说明的短枢纽页,并补写加载场景/动作页。
为 /v2、/v2/install、/v2/migration 增加 index,避免 generated-index 落到 /category/ 后 404。

Co-authored-by: Cea <ceastld@users.noreply.github.com>
what's-new 目录不改名;sitemap loc 将 ' 编码为 %27,避免 XML 消费端失败。
页脚「文档中心」改为「1.x 文档」,并增加官网 V2 入口。

Co-authored-by: Cea <ceastld@users.noreply.github.com>
新增 AI/Agent 现状页,不承诺 Agent 或手机遥控已对普通用户开放。
触发概览去掉「即将补充」,并如实标出仍缺独立说明的项。
编写约定对用户侧栏隐藏;模块分类描述去掉重复用词。

Co-authored-by: Cea <ceastld@users.noreply.github.com>
slug 为 /v2 时,相对目录链接会被解析到站点根并触发 onBrokenLinks。

Co-authored-by: Cea <ceastld@users.noreply.github.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 16, 2026

Copy link
Copy Markdown

Deploying docs-getquicker-net with  Cloudflare Pages  Cloudflare Pages

Latest commit: ea6b6f1
Status: ✅  Deploy successful!
Preview URL: https://793199b5.docs-getquicker-net.pages.dev
Branch Preview URL: https://cursor-fix-v2-user-docs-3d62.docs-getquicker-net.pages.dev

View logs

:::caution 后的标题需写成 [Preview · 仅专业版],否则会按普通段落输出。

Co-authored-by: Cea <ceastld@users.noreply.github.com>
@ceastld
ceastld marked this pull request as ready for review August 16, 2026 23:31
@ceastld
ceastld merged commit be96600 into main Aug 16, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants